home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 36 / q36.d81 / t.disk file '97 < prev    next >
Text File  |  2022-08-28  |  18KB  |  435 lines
  1.  
  2.  
  3.                          D I S K   F I L E   ' 9 7
  4.  
  5.           Original Disk File by Bill Crooks (in the public domain)
  6.  
  7.          Additional enhancements and modifications by Doreen Horne
  8.  
  9.                Loadstar 128 version and text by Bob Markland
  10.  
  11.  
  12. FENDER'S PREMUMBLE: This is the text for Bob Markland's late-1997 upgrade
  13. of DISK FILE 128. Doreen Horne, along with many other users from Australia,
  14. is more familiar with the original program, and has asked that I publish
  15. the original, rather than the upgrade. However, on the 5.25" version of LS
  16. 128 #36, there's room for only one version so I decided to run Bob's
  17. version, to which the following text applies. If anyone who gets the 5.25"
  18. version feels that they MUST have the original version, write me and ask,
  19. and I'll send you a disk with the original program (which has minimal docs)
  20. on it. Bob didn't change all that much, so the docs below more or less
  21. apply to the original version too. Here are Bob's docs, which are so large
  22. they must be broken into two parts.
  23.  
  24.  
  25.     Doreen Horne, LOADSTAR's programmer from downunder, needed a program to
  26. catalog her large disk collection. After some searching, she found Disk
  27. File for the 128 but it didn't quite fit her needs. So, she did what any
  28. Commodore owner with an interest in programming can do. She modified and
  29. enhanced it, adding new features and capabilities, until it did exactly
  30. what she wanted.
  31.  
  32.     Doreen added lowercase/uppercase capabilities, wild card search, edit
  33. of the IDs, and partial saves, but retained the original PD look. What you
  34. will find here is a package that features menus, liberal on-screen prompts,
  35. and instructions. The custom font aids in reading filenames, particularly
  36. GEOS, which contain graphics characters as viewed from the directory.
  37.  
  38.     Following this metamorphosis, Ron Schahrer, Bill Crooks and Doreen may
  39. not recognize their program, but I trust they will be pleased. There are
  40. some things we may have done differently, but DISK FILE '97 is large and
  41. complex. With its sort capabilities and capacity for 2100 records,
  42. virtually no area of memory remains unused.
  43.  
  44.     DISK FILE '97 is a maze of options and features. We have added
  45. additional error trapping and made the cataloging process as user friendly
  46. as possible, but we were unable to recreate every conceivable condition or
  47. situation. For those with a penchant for poking some "off-the-wall" key
  48. just to see what happens -- you won't be disappointed - DISK FILE '97 will
  49. probably crash.
  50.  
  51.     Because of its size, DISK FILE '97 consists of three modules, 128 Disk
  52. File, the Printer Module, and DCMR Conversions. These are NOT free-standing
  53. units and cannot be run independently. Always enter the program via the
  54. DISK FILE '97 Boot Menu. The printer module is accessible from the Boot
  55. Menu or the main program.
  56.  
  57.     The data files created with DISK FIlE '97 can become very large and
  58. there is limited free space on the LOADSTAR disk. Use LOADSTAR's "Copy It"
  59. or a file copier to transfer all of the DISK FILE '97 files to a blank
  60. disk. Data files may be added or stored on a disk of their own.
  61.  
  62.     Although DISK FILE '97 was designed to catalog programs, it can be used
  63. for catalogs of Print Shop icons, magazine articles, word processor
  64. documents, etc. In fact, it is also useful for record, video tape or photo
  65. collections.
  66.  
  67.  
  68.  DISK FILE '97
  69.  -------------
  70.  
  71.     Begin from the Boot Menu and use CRSR DN/UP and RETURN to select either
  72. DISK FILE '97 or DCMR CONVERSIONS. If you already have data stored in the
  73. DCMR disk catalog format, you may wish to skip ahead to the conversion
  74. instructions and create DISK FILE '97 compatible files now. Otherwise,
  75. select the DISK FILE '97 option.
  76.  
  77.     When cataloging for the first time, take a few minutes to plan how you
  78. want the catalog laid out. DISK FILE '97 can accommodate 2100 records in
  79. each of 15 different categories. If you don't expect the total number of
  80. records to exceed 2100, a single catalog may be the best choice. Or you can
  81. catalog groups of like items such as LOADSTAR, Utilities, GEOS,
  82. productivity, etc. in separate catalog files. The choice is yours, but a
  83. little planning can save time in the future as you add more data. Don't be
  84. overly concerned, though, DISK FILE '97 is capable of combining categories
  85. or saving selected parts of one category to another.
  86.  
  87.     Each time the program is run it asks for your disk drive configuration.
  88. First, identify the drive that will hold the DISK FILE '97 catalog files.
  89. Then select the drive from which to read data to be included in your
  90. catalog. Choose 8 at both prompts for a single drive and you will be
  91. prompted to swap disks when necessary. DISK FILE '97 is compatible with
  92. 1541, 1571 and 1581 drives. It has also been tested with CMD native mode
  93. partitions. If you find a need (on a MULTIPLE DRIVE system ONLY) you can
  94. pre-configure a sub-directory on a 1581 drive before running the program.
  95.  
  96.     Next, choose the case conversion option as follows:
  97.  
  98.  (1) - All data retrieved from directory reads is converted to lowercase.
  99. This eliminates cryptic graphics characters found in GEOS filenames and you
  100. can later print your catalog in either lowercase or uppercase.
  101.  
  102.  (2) - All directory data is processed in its original form. True GEOS type
  103. filenames are retained.
  104.  
  105.     Under nearly all circumstances it is preferable to use option 1. The
  106. printed catalog is easier to read and some printers will not print graphics
  107. characters in the 5 column condensed mode.
  108.  
  109.  NOTE: To facilitate editing directory input, the custom font is configured
  110. in such a way that all text appears on the input screen in
  111. lowercase/uppercase format. When using option 1, the case change becomes
  112. apparent when you view a catalog on-screen or use the printer module.
  113.  
  114.     All DISK FILE '97 options are available from the Main Menu. Use CRSR
  115. DN/UP and RETURN to select. Many of the options have sub-menus and options;
  116. use CRSR DN/UP or answer the prompt as requested. The system is color
  117. coded. Standard functions are blue. Errors and actions which may be
  118. destructive to all or part of the data are red or black. Advisory messages
  119. are purple or cyan.
  120.  
  121.  
  122.  Create or Add to a Record File
  123.  ------------------------------
  124.  
  125.     This is the area where new data is entered, using any of the various
  126. options. When there are no records in memory you are asked if you wish to
  127. start a new catalog or return to the menu to load an existing catalog.
  128.  
  129.     To create or add to a catalog use one of the following methods:
  130.  
  131.  Manual Input (With Directory Read)
  132.  ----------------------------------
  133.     From the sub-menu the directory in the designated drive may be viewed
  134. to determine what information you will manually enter into the catalog. You
  135. can skip the directory and immediately move to the data entry mode or abort
  136. to the main menu.
  137.  
  138.     Once in the data entry mode, enter any four character ID. The purpose
  139. of this ID is to identify the disk from which the information came. For
  140. example: Suppose you have disk boxes (labeled A, B, C, etc.) and that each
  141. box holds numbered disks containing several types of programs. An ID of
  142. A69S would identify the files on a disk from box A, numbered 69, which
  143. contains Spreadsheet programs.
  144.  
  145.     Both lowercase and uppercase are supported, but keep the ASCII values
  146. in mind for sorting purposes -- numbers 0-9 come before alphabetical
  147. characters, lowercase a-z come before uppercase A-Z.
  148.  
  149.     Use delete or cursor left and right to correct any errors, then press
  150. RETURN when you are satisfied with the ID. To quit at any time enter a
  151. single lowercase "q" and press RETURN.
  152.  
  153.     Next, enter a name consisting of from 1 to 16 characters and press
  154. RETURN. It is generally preferable to enter all text in lowercase, however
  155. uppercase is supported.
  156.  
  157.  
  158.  Input from Disk Directory
  159.  -------------------------
  160.     This function automates the process of assembling a catalog. Place the
  161. disk to be cataloged in the requested drive, then enter an ID as described
  162. above.
  163.  
  164.  NOTE: With some commercial software you will encounter non-standard
  165. directories. In some cases filenames contain color and control characters
  166. which prevent the directory from listing normally. DISK FILE '97 IS NOT
  167. equip